Fsymlink(2)               Oct. 7, 1991                Fsymlink(2)



NAME
     Fsymlink - create a symbolic link to a file

SYNOPSIS
     LONG Fsymlink( char *oldname, char *newname );

DESCRIPTION
     Fsymlink creates a new symbolic link (a "soft link") for the
     file  currently named oldname.  If the Fsymlink call is suc-
     cessful, then after the call the file may be referred to  by
     either  name.  A  call  to  Fdelete on the new name will not
     affect the existence of the file, just of the symbolic link.
     A  a  call  to  Fdelete  with the name oldname will actually
     delete the file, and future  references  with  newname  will
     fail.

     Unlike hard links, symbolic links may be made between  files
     on  different  devices  or even different types of file sys-
     tems.

RETURNS
     0 on success

     EINVFN if the file system does not allow symbolic links

     An appropriate error code if the new symbolic link cannot be
     created.

SEE ALSO
     Flink(2), Freadlink(2), Frename(2)

BUGS
     No check is made for the existence of the  file  named  old-
     name; this could be construed as a feature.





















Version 0.9   Last change: MiNT Programmer's Manual             1